home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / ISAPNPTO.{13 / INSTALL.{_1 < prev    next >
Text File  |  1999-09-17  |  5KB  |  155 lines
  1.     ISA PnP utilities Installation
  2.     ==============================
  3.  
  4.         $Id: INSTALL,v 0.6 1999/02/14 22:37:02 fox Exp $
  5.  
  6. Note that isapnptools no longer requires pciutils as of version 1.18.
  7.  
  8. 1) Edit the makefile to suit local conditions.
  9. ---------------------------------------------
  10. Note that these will depend on your library versions. The
  11. Makefile as supplied is for libc-5.4.44. If you have a newer
  12. library, then some of the syscalls may already be provided
  13. in the library, so remove the appropriate -D.
  14. For example: If you get an error message such as
  15.  
  16. pnpdump.c:29: conflicting types for 'nanosleep'
  17. usr/include/time.h:122: previous declaration of 'nanosleep'
  18. make: *** [pnpdump.o] Error 1
  19.  
  20. then you need to remove the -DNEEDSNANOSLEEP from the PNPFLAGS
  21. line in the Makefile. (This has already been done now, but
  22. a similar comment applies to the other system calls added).
  23.  
  24. 2) As anyone,
  25. ------------
  26. make
  27.  
  28. to make the programs isapnp and pnpdump.
  29.  
  30. 3) As root,
  31. -----------
  32. make install
  33.  
  34. or if you prefer, just make install.man or install.bin
  35. if you do this, you'll need to copy the isapnp.gone
  36. file to /etc manually.
  37.  
  38. 4) Read the manual pages, particularly isapnp.conf.5.
  39. -----------------------------------------------------
  40.  
  41. 5) Edit the /etc/isapnp.gone file:
  42. ----------------------------------
  43. to specify resources that are unavailable. Typically these will be
  44. identifiable by entering the BIOS and writing down the information you
  45. find there.
  46.  
  47. 6) Run pnpdump to generate an isapnp.conf file:
  48. -----------------------------------------------
  49. pnpdump > /etc/isapnp.conf
  50.  
  51. pnpdump can optionally take up to two command line parameters,
  52. see the manual page for details.
  53.  
  54. It can also take the option --config which makes it
  55. attempt to produce a preconfigured configuration file,
  56. see the manual page for details. If you got the entries
  57. in /etc/isapnp.gone correct, the output file should
  58. not require editting, and you will be able to skip the
  59. next step, though you may still want to check it.
  60.  
  61. 7) Edit the isapnp.conf file to place the device(s)
  62. ---------------------------------------------------
  63. where your driver(s) expect. This is where step 4 would have
  64. been useful.
  65.  
  66. If you are configuring a sound card read the FAQ section. In
  67. fact, read the appropriate FAQ section anyway.
  68.  
  69. The purpose of this step is to insert/correct the resource assignments
  70. in the isapnp.conf file so that the ISA PnP devices are all configured
  71. without their resource allocations conflicting with any other devices.
  72.  
  73. The comments below assume you ran pnpdump without the --config
  74. flag. If you did, then you will need to check the allocations don't
  75. conflict with existing hardware whether or not it was in use at the
  76. time you ran pnpdump.
  77.  
  78. a) All configuration information is commented out, so uncomment
  79. the lines beginning with '# (' that you want to use.
  80.  
  81. b) If the resource data specified a range of values, then only
  82. the first will be put in the config entry. This should be editted
  83. to suit.
  84.  
  85. c) DON'T FORGET to uncomment the (ACT Y) at the end of the logical
  86. device entry if you want the device enabled !
  87.  
  88. If you have a working Win95 setup, you might like to edit the
  89. resource allocation while running Win95, so you can check the
  90. resource allocation under My Computer -> Properties -> Device
  91. Manager -> etc etc. See README.DOS.
  92.  
  93. To see what resources are already in use by the kernel, try
  94. the following commands:
  95.  
  96. dmesg  | grep -i irq
  97. cat /proc/interrupts
  98.  
  99. If you want to see what has been configured, without the noise
  100. of the comments, grep out the comments etc thus:
  101.  
  102. cat isapnp.conf | grep -v '^#' | grep '[^     ]' | less
  103.  
  104. where there is a tab and a space in the square brackets above.
  105.  
  106. 8) Run isapnp
  107. -------------
  108. on the isapnp.conf file to check it has no errors. I should
  109. sync the disks before you do this one if you have SCSI disks
  110. or IDE disks on an ISA PnP expansion card, in case you reset
  111. them.
  112.  
  113. 9) Do whatever is necessary to initialise the device drivers:
  114. -------------------------------------------------------------
  115. run setserial, or insmod the drivers. Check they work.
  116. Refer to the README, README.modules and README.ide for more details.
  117.  
  118. 10) Edit the system bootup scripts
  119. ---------------------------------
  120. to run isapnp and install the drivers etc as above.
  121.  
  122. 11) Problems
  123. ------------
  124. If you have any problems, please look at the isapnptools home
  125. page at
  126.  
  127. http://www.roestock.demon.co.uk/isapnptools/
  128.  
  129. and read the FAQ available in the distribution, or get the latest at
  130.  
  131. http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html
  132.  
  133. first. This has additional examples to the various READMEs
  134. contained in the distribution, and pointers to other help
  135. available.
  136.  
  137. See also your Linux distribution's support documentation.
  138.  
  139. 11) How you can help others
  140. ---------------------------
  141. If you have an example configuration file, or new hardware
  142. drivers etc, which would be of assistance to others, don't keep
  143. them to youselves, please send them, or pointers to them, to
  144.  
  145. isapnp@roestock.demon.co.uk
  146.  
  147. so that I can include them in the FAQ, thanks.
  148.  
  149. Also, if you have successfully configured a PnP device that is not
  150. listed in the Hardware-HOWTO, please notify the maintainer, as it
  151. requests.
  152.  
  153. Peter Fox
  154. 14-Feb-99
  155.